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New IIgs Books from Apple 


We now have copies of three new books from Apple, via Addison- 
Wesley Publishing . The "“ProDOS-8 Technical Reference Manual" 
replaces the old “ProDOS TRM“. It is still the same price, but 
it is slightly updated and is now a hardcover book rather than 
Spiral-bound paperback. In fact, all of the new Apple books are 
apparently in hard-cover. They are very well made books. 


The "Apple IIgs ProDOS-16 Reference* is a brand new book, and one 
you need if you are going to be programming for the ProDOS-16 
environment. Even more important to IIgs programmers is the new. 
“Apple IIgs Firmware Reference“. See inside for more information 
about both of these and other new titles in the series. 


Is the "Sider" Still Available? 


We have had a lot of callers ask this question, so we finally 
called Xebec to find out. The answer is "Yes", but not through 
direct phone or mail orders from First Class Peripherals. You 
now have to order them through dealers, of which there apparently 
quite a few. You can get a list of dealers near you by calling 
(800) 982-3232. Meanwhile, we are trying to get set up as 
dealers ourselves. If you are in the market for a good 20- or 
40-megabyte hard disk, give us a call, 


Clearing Some Mist from Super-HiRes.......Bob Sander-Cederlof 


The Apple IIgs has lot of new features, and one of the most 
obvious is the new Super HiRes graphics mode. It allows 
display of 200 lines of either 320 dots or 640 dots each. In 
the 320x200 mode each dot is represented by four bits, and in 
the 640x200 mode each dot is represented by two bits. A scan 
control byte for each of the 200 lines determines whether that 
line is 320 or 640 pixels, and which of 16 color palettes to 
use for that line. 


By experimentation, I found the description of Super HiRes in 
the Apple documentation to be incorrect in some areas. Other 
sources of information I found were incomplete. Hopefully the 
following will fill in some of the gaps, and correct some of 
the errors. If you catch me making some new ones, please let 
me know! 


The information which controls the super hires display consists 
of three elements: the picture, the scan control bytes, and 
the color palettes. There are 200 scan control bytes (SCB's), 
one for each line of graphics. The low-order four bits of each 
SCB are the palette number to use for that scan line. Bit 7 
indicates whether the scan line is in 320- or 640-mode. Bit 6 
controls the generation of an IRQ interrupt at the beginning of 
tne scan line. Bit 5 selects the fill mode. Bit 4 is not used 
(yet). (The SCB description in the documentation I have from 
Aople erroneously has the 320/640 bit in bit 0, and the palette 
ljadex in bits 7-4.) 


There are 16 color palettes, each having 16 two-byte color 
eitries. The color used for each individual pixel is 
controlled by the palette number from the scan control byte, 
the pixel value, and (in 640-mode) the pixel position. The 
bits in each palette control the brightness of each of the 
tnree primary video colors, red, green, and blue. Bits 15-12 
of the palette entry are not used. Apple says to Keep these 
zeroed, in case they think of some way to use them in the 
future. Bits 11-8 are the intensity value for red; bits 7-4, 
green; and bits 3-0, blue. 


All the soft switches which control Super HiRes are at $C029. 
Bit 7 turns Super HiRes on and off. Bit 6 controls the order 
that software sees the bytes in the display area. Bit 0 of 
this byte needs to remain set to 1 or the IIgs crashes. To 
turn on Super HiRes, store S$Cl or $81 at $C029; to turn it off, 
store $41 or $01. I prefer $Cl and $41, because this leaves 
the graphics area in what Apple calls “linear” address order. 


The bytes from $2000 through S9FFF in bank SEl are used for 
Super HiRes. (If shadowing is on, the same addresses are also 
available in bank $01.) When bit 6 of $C029 is set toal, 
these bytes are in a nice logical order for software access. 
Locations $2000-S9CFF are the picture area of 32000 bytes. 
Each scan line occupies 160 contiguous bytes in this range. 
The 200 scan control bytes run from $9D00 through $9DC7. The 
56 bytes at S$9DC8-9DFF are not used for anything at this time. 
Apple says they should be cleared to zero, but they do not do 
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S-C Macro Assembler Version 2.0......DOS $100, ProDOS $100, both for $120 
Version 2.0 DOS Upgrade Kit for 1.0/1.1/1.2 ownerS....ccccccseccccceee S20 
ProDOS Upgrade Kit for Version 2.0 DOS OWnerS...ccccccrccccccsccccccces 9 30 
Source Code of S-C Macro 2.0 (DOS or ProDOS)........each, additional $100 
S-C DisAssembler (ProDOS only)...without source code $30, with source $50 
RAK-Ware DISASM (DOS only).......without source code $30, with source $50 
ProvVIEW (ProDOS ON LY) o o:6 660065 600 Whee HENSON ONES SK NOOO ete we ween ee e920 
Full Screen Editor for S-C Macro (with complete source code) .......+.«$49 
S-C Cross Reference Utility......without source code $20, with source $50 
S-C Word Processor (with complete source Code) ...ccccrccccccccccccecee 900 
DP18 and DPFP, including complete source and object code.......0.02+.-$50 
ES-CAPE (Extended S-C Applesoft Program Editor) .....csceeee 

Including Version 2.0 With Source Code..........$50 
ES-CAPE Version 2.0 and Source Code Update (for Registered Owners) ....$30 
Bag of Tricks 2 (Quality Software) ....ccccccccccsccccccsscce (949.95) $45 
MacASM -- Macro Assembler for MacIntosh (Mainstay)........-($150.00) $50 * 
S-C Documentor (complete commented source code of Applesoft ROMS).....$50 
Cross Assemblers for owners of S-C Macro Assembler.....$32.50 to $50 each 

(Available: 6800/1/2, 6301, 6805, 6809, 68000, Z-80, 2-8, 8048, 
8051, 8085, 1802/4/5, PDP-ll, GI1650/70, others) 

Beagle Bros. Applesoft Compiler (ProDOS only) ....ceccccccsee ($74.95) $65 * 


% 


AAL Quarterly DiBkBS....cccccccccvcccvcccees-€ach $15, or any four for $45 
Each disk contains the source code from three issues of AAL: 
Jan-Mar, Apr-Jun, Jul-Sep, and Oct-Dec. 
(All source code is formatted for S-C Macro Assembler. Other assemblers 
require some effort to convert file type and edit directives.) 


Diskettes (with hub ringS)...c.ccccccccccsccccccecece package of 25 for $15 * 
Vinyl disk pages, 6"x8.5", hold two disks each....ccccccccceceeeelO for $6 * 
Diskette Mailing Protectors (hold 1 or 2 disks).............40 cents each 
(Cardboard folders designed to fit 6"X9" Envelopes.) or $25 per 100 * 
Envelopes for Diskette MailerS.....cccccessccccccccseccveee 6 Cents each 


65802 Microprocessor (Western DeSign Center) ..cc.cccccccccccveccccces $25 
quikLoader EPROM System (SCRG) dove oo 0re Slale 6 46 Go wie SSC SS SES Ewe ee Cols 9D) $170 
PROmGRAMER CS ORG )ios5 seo co 0S We 6 OW OE Se Se WE wae esos were S249:..50) $140 
Minuteman 250 Uninterruptible Power Supply......ccececcccccseee (9399) $320 


+2 & @ 


"Apple //gs Technical Reference", Fischer.cecccccccccccccces ($19.95) $19 
"65816/65802 Assembly Language Programming", Fischer........($21.95) $20 
"Programming the 65816", EyeS...ccccccccccccccccsccscccccces (9220.99) $21 
“Apple //e Reference Manual", Apple Computer.....ccccccccees ($24.95) $23 
"Apple //c Reference Manual", Apple Computer.....ccccccccceee ($24.95) $23 
"ProDOS-8 Technical Reference Manual", Apple Computer.......($29.95) $27 
“ProDOS-16 Technical Reference Manual", Apple Computer......($29.95) $27 
“Apple IIgs Firmware Reference", Apple Computer.....-eceeeee ($24.95) $23 
“ProDOS Inside and Out", Doms & WeisShaar....ccccccceccccceee ($16.95) $16 
“pOStalk Scrapbook", Weishaar & KerSey...ecccccscccccccvcece (914.95) $14 
"Beneath Apple ProDOS", Worth & LeEChner...cccccccccceccccces ($19.95) $18 
"Beneath Apple DOS", Worth & LeEChneLr...cccrcccccccccccccecee (919.95) $18 
“Inside the Apple //c", Little.c.cwcccsccscccvcccccsececcscece (919.95) $18 
"Inside the Apple //e", Little...c.cccccccccsevecccsccvcvecccces (919.95) $18 
"Understanding the Apple //e", Sather...cccccccccccscvcccescce ($24.95) $23 
"Understanding the Apple II", Sather... ccccrcccccccccccccscee (922.99) $21 
"Apple II+/IIe Troubleshooting & Repair Guide", Brenner.....($19.95) $18 
“Apple ){ Circuit Description", Gayler.....cccccccccccsccsee(922e99) $21 
“Assem. Language for Applesoft Programmers", Finley & Myers.($18.95) $18 
"Now That You Know Apple Assembly Language...", Gilder......($19.95) $18 
“Enhancing Your Apple II, vol. 1", Lancaster... ...ccccvcscceee ($15.95) $15 
“Enhancing Your Apple II, vol. 2", Lancaster.....cscccccesese(Sl7.95) $17 
“Assembly Cookbook for the Apple II/IIe“, Lancaster........-($21.95) $20 
“Microcomputer GraphicS", MYErS.ccccccccccccccccsscccccscces (914.95) $14 
"Assembly Lines -- the Book", Wagner... cccccccccccscceccecese (919.95) $18 
"AppleVisions", Bishop & GrOSSDEIGeLl..cccccccrccccccccvccscee (939.95) $36 
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* On these items add $2.00 for the first item and 
$.75 for each additional item for US shipping. 
+ Inquire for shipping cost. 
Foreign customers inquire for postage needed. 
Texas residents please add 7.25 % sales tax to all orders. 


*** S-C SOFTWARE, P. O. BOX 280300, Dallas, TX 75228 *** 
se (214) 324-2050 wae 
*** Master Card, VISA, Discover and American Express *** 
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s0 in their own software. The color palettou are kopt in 
S9EOO-9FFF, 32-bytes for each palette. 


When bit 6 of $C029 is cleared to zero, the Super Hikeu data is 
located differently. It is still in bank SE] trom §2000 
through S9FFF, but in a different order. All the even bytes of 
the picture are stored in $2000-5E7F; the even scan control 
bytes, in SSE80-5EFF; and the even bytes of the palettes, in 
SSFOO-SFFF. The odd bytes are found in the corresponding 
positions in $6000-9FFF. I don't know why Apple gave us the 
ability to see the bytes in this order, but apparently this is 
the order the video hardware sees. Software will almost always 
set bit 6 and see them in the “linear” order. 


In 320-pixel mode, the pixel number is a value from 0 to 319 
decimal, or 0 to $013F hex. If we divide the pixel number by 
two, the quotient gives the byte position on the line and the 
remainder gives the pixel position in the byte. Pixel 0 ina 
byte is in bits 7-4, and pixel 1 is in bits 3-0. The 4-bit 
value of a pixel is used as an index to pick one of 16 colors 
out of the palette designated for the line. 


In 640-pixel mode, the pixel number is a value from 0 to 639 
decimal, or 0 to $027F hex. If we divide the pixel number by 
four, the quotient gives the byte position on the line and the 
remainder gives the pixel position in the byte. Pixel 0 ina 
byte is in bits 7 an 6, pixel 1 ig in bits 5 and 4, and so on. 
Let's look at a 16-bit pixel number, and break it down this 
way: 000000ab cdefghij. Then the byte number in the scan line 
is “abcdefgh", and the pixel number is “ij". The index used to 
pick which of 16 colors in the current palette to use for the 
pixel is computed by adding the two-bit pixel value to four 
times the pixel position. 


Stating it again, in a different way, the address of the color 
bytes for an individual pixel can be easily calculated, using 
one of the following formulas: 


320-mode S9EOO + PPPP*32 + pppp*2 
640-mode S9EOO + PPPP*32 + xxpp*2 


where S9E0OO is the base address for the 16 palettes; PPPP is 
the palette # from the scan control byte; pppp is the 4-bit 
pixel value in 320-mode; xx is the low-order two bits of the 
pixel number in 640-mode, and pp is the two-bit pixel value in 
640-mode. 


Probably most users of the Super HiRes graphics will use the 
320-pixel mode, because it is so easy to get 16 brilliant 
colors for every pixel. Most uses of the 640-pixel mode will 
probably be displaying text in one of three colors with the 
background set to a fourth color. By storing the same four 
colors in each of the four groups of a palette, you can easily 
achieve the four-color effect. However, you are not LIMITED to 
four colors. By being VERY smart and careful, you could use 16 
different colors in the 640-pixel mode. 


ANother interesting puzzle, at least to me, is how to determine 
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Multiply memory — Add up to 


1 MEG with Z-RAM Ultra. \ 


Multiply speed — Run and load 
programs up to 30 times faster. 


Multiply production — Printer —___ 
buffer lets vou keep working 
while the system prints 
AppleWorks files. 


Imagine multiplying your AppleWorks 
word processor capacity over threefold 
to 22,600 lines from its present 7,250. 

Multiplying your maximum number 
of records to 22,600 from the current 
6,350. And available desktop memory 
rockets to over 700K with ail of 
AppleWorks loaded into RAM. 

You can do all of that and more with 
the Z-RAM Ultra expansion board for 
Apple Hic’s. 

Z-RAM Ultra completely loads pro- 
grams into RAM, then runs them up to 
30 times faster. And the included RAM 
disk is compatible with Applesoft, PRO- 
DOS, DOS 3.3, PASCAL and CP/M®. 

Z-RAM Ultra even expands the clip- 
board and autosegments large files so 
they can be saved on two or more 
disks. Nothing else even comes close to 
enhancing AppleWorks like this! 

There’s lots more. 

Memory and speed just begin the 
story. Z-RAM Ultra 3 has a built-in 
Z-80B microprocessor so it can run 
CP/M programs. That's the largest body 
of software in existence and includes 
WordStar, dBase Il, Turbo PASCAL, 
Microsoft BASIC and more. 
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Ic multiplied. 


With Ultra 2 & 3, there's a PRO-DOS 
compatible, battery-backed up clock 
that displays time and date on 
AppleWorks screens and time and date 
stamps any PRO-DOS file. 

There’s an AppleWorks printer buffer so 
you keep working while files are printed. 

With its patented technology and 
computer aided design, Z-RAM Ultra 
runs with less than half the power drain 
of other memory cards. 

Easy to install. 

_ It's easy to get all that performance. 
Z-RAM Ultra installs in just a few min- 
utes with a screwdriver — no jumper 
wires, no clips, no drive removal. 

A complete package. 

7-RAM Ultra comes with simple, 
easy-to-follow instructions, RAM disk 
software, Z-80 operating system, CP/M 
manual, a five-year “hassle-free” war- 
ranty, and all the AppleWorks enhance- 
ments we're famous for. 

See your dealer or call today. 

For more information or to order 
your Z-RAM Ultra, see your dealer or 
call 214-241-6060 between 9 am and 
11 pm, 7 days. Or send check or money 
order to Applied Engineering. 


Multiply value — Get Pinpoint's 
AppleWorks accessories with 


ordered with Z-RAM Lltra. 


\ ee RAM enhancement software, a 
— $118 value, for only $79 if 


e Multiply efficiency — Optional 
3 e- 65C816 16-bit processor plugs in 
ae easily with no other component 

changes. 


“—— Multiply applications — Run 
CP/M programs with built-in 
Z-80B microprocessor. 


Prices 
Z-RAM Ultra 3 (with memory, clock 
and CP/M) 


265K — $329.00 512K — $379.00 
1 MEG — $459.00 

Z-RAM Ultra 2 (with memory and 
clock) 

256K — $269.00 512K — $319.00 
1 MEG — $399.00 


BARC EME TH 


ee ee 
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MasterCard, Visa and C.0.D. welcome. 
Texas residents add 614% sales tax. Add 
$10.00 outside U.S.A. ) 


CP/M is a registered trademark of Digital Research. Inc. 


Fa wa Applied Engineering 
The Apple enhancement experts. 


P.O. Box 798, Carrollton, TX 75006 
(214) 241-6060. 
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what color numbers to use to get a particular color on the 
screen. When I was in kindergarten they told me about mixing 
red, blue, and yellow water colors to get purple, yreen, 
Orange, brown, and so on. But when you are mixing light, you 
start with red, green, and blue. If you mix all three in equal 
amounts you get the shades of gray. A palette entry of $0444 
would be a dark gray, $0888 a light gray, and SOFFF we could 
call white. Red and blue mixed together still make purple, 
but red and green make yellow! You artists and photographers 
and video experts out there already know all this, but it is 
still mysterious to me. 


Here is a chart showing some more color values: 


RGB _ Color RGB Color 

8 41 #£4xBrown 7 2 C Dark Purple 
F 7 0 Orange FA9_ Pink 

00 F Dark Blue 0 EO Light Green 
F FO Yellow DAF Light Purple 
0 8 0 Dark Green 4 DF Light Blue 
DOO Red 7 8 F Grayish-Blue 


The following program will turn on the super hi-res graphics 
and draw a picture showing the above colors in 16 vertical 
stripes. The bottom 16 scan lines will show a second palette 
of colors, which I have set to shades of gray. 


Line 1020 tells the S-C Macro Assembler to allow assembly of 
65316 opcodes and addressing modes. Lines 1070-1080 turn on 
the super hi-res graphics, and lines 1180-1190 turn it back 
off. Lines 1100-1120 call subroutines to set up the scan 
control bytes, load in two palettes of colors, and draw the 
“picture“. Lines 1140-1160 wait until any key is pressed. So, 
after assembling with the S-C Macro Assembler, typing “MGO T" 
will cause the picture to appear. Then pressing any key will 
bring back the text screen. 


The scan control bytes for the first 184 lines will all equal 
$00, because I want 320-pixel mode and I am using palette 0. 

The last 16 lines I use $01 for the SCB values, to draw them 

using palette l. 


Lines 1780-1810 save the current 65816 mode and enter the 
Native Mode. Lines 1960-1980 restore the original mode. Lines 
1830-1940 generate 32000 bytes of picture data. Each scan line 
has 160 bytes of pixels. My loops here store ten zeroes, ten 
$ll-bytes, ten $22-bytes, and so on through ten SFF-bytes in 
each scan line. I used 16-bit mode for the index registers, 
and 8-bit mode for the A-register. 


After you have run the program once and seen the color stripes, 
you might like to go back and change line 1860 to LDY ##5. The 
assemble and run it again. You will get two sets of color 
stripes of half the width of the previous picture. Then you 
rt try changing it to other even multiples of 5, like 20 and 
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1010 .OP 8 
1020 *SAVE S. TEST. SHRC 
1080 ® TEST SUPER HI-RES COLOR 
iia cia 
ait aoe A? ae Ld aor ne Turn on super hi-res screen 
1090 #---Build Picture--<----<--------- 
000805- 20 08 1100 JSR SCAN.CONTROL .BYTES 
itt tae ee ES wSh PICTURE 
1130 #--Wait till keypress----------- 
OOO80E- AD co 11ho .1 LDA $C000 
000811- 10 1190 BPL .1 
000813- 8D 10 CO 1 0 —_ a eee 
aaa ur. S@e @eeeeaeoee 
000816- A9 1160 LDA #$f1 
000818- 8D co 1190 STA $C029 
00081B- 60 1200 ; RTS 
1220 SCAN. CONTROL .BYTES 
00081C- A 1230 LDA #0 Palette 0, 320-pixel mode 
SSabst- BF gg 9D 81 185g <1 EE Hegooony 
000 28 - 0 1270 BCC .2 Use paiette 1 for lines 
O0082A- E 1290 .2 INX 
00082B- DO 1300 BNE .1 
00082D- 60 1339 RTS 
1 30 PALETTE 
O0082E- A2 3F 1340 X #PALSIZE-1 Copy the two palettes 
000830- BD 3 1350 .1 LDA PALDATA,X into palette area 
000833- 9F 00 9E £1 1360 STA $£19E00,X 
000837- CA 1 79 DEX 
000838- 10 F6 1380 BPL .1 
00083A- 60 1390 . RTS 
1410 PALDATA 
00083B- 00 00 1420 .HS 00.00 K 
0008 F- 10 1480 "Hs 4§206.0 BROWNS 
000881- 2C 07 1450 -HS 20.07 DARK PURPLE 
00083 - OF 00 1460 -HS OF.0 DARK BL 
000845- 80 00 1470 .HS 80.0 DARK GREEN 
G008o= OO OD 190 "HS. 00: 0D isa 
Sas a a ee ce 
O90RuF EO 00 iB20 "HS £0.00 LIGHT GREEN 
000851-. DF O04 1530 -HS DF. LIGHT BLUE _. 
a ee ce a 
= e e Ye 
000 of - cc 0 1226 HS BOF LIGHT GREY 
000859- FF OF 1570 , .HS FF.OF WHITE 
1580: @eseceece csc cee sec ce coca east 
gengep- 92 go Rg gg lace 
O0085F- 22 02 1610 “HS 22.02 VARIOUS 
000861- 33 0 1620 HS 33-93 SHADES 
000 3- 0 1 30 “HS 44:0 OF 
000865- 29 0 1640 - HS 2p- 08 GRAY 
000867- 66 0 1650 “HS 66.0 
SooReB. BB erg "HS 6608 
O00880- 99 09 1680 -HS 99.09 
00086F- OA 1 90 -HS AA.OA 
soars oe Bea BBG 
TB DD OD 1920 -HS DD. OD 
o00BTo- EE oF i7ho "HS FELOF WHIT 
4o- 1750 PALSIZE .£Q *—PALDATA 
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SPECIAL !!! EXPANDED RAM/ROM BOARD. $3900 
Similar to our $30 RAM/ROM dev board described below. Except this board has two sockets to hold your choice 
of 2-2K RAM, 2-2K ROM or even 2-4K ROM for a total of 8K. Mix RAM and ROM too Although Apple limits 
access to only 2K at a time, soft switches provide convenient socket selection. Hard switches control defaults. 


IMPROVED 11! IL INA MAC (ver 2.0): $75.00 
Now includes faster graphics, UniDisk support and more! Bi-directional data transfers are a snap! This Apple |! 
emulator runs DOS 3.3/PRODOS (including 6502 machine language routines) on a 512K MAC or MACPLUS. All 
Apple |i features are supported such as HI/LO-RES graphics, 40/80 column text. language card and joystick. 
Also included: clock, RAM disk, keyboard buffer, on-screen HELP, access to the desk accessories and support 
for 4 logical disk drives. includes 2 MAC diskettes (with emulation, communications and utility software. plus 
DOS 3.3 and PRODOS system masters, including Applesoft and Integer BASIC) and 1 Apple II diskette. 


SCREEN.GEN: $35.00 
Develop HI-RES screens for the Apple || on a Macintosh. Use MACPAINT (or any other application) on the MAC to 
create your Apple Il screen. Then use SCREEN.GEN to transfer directly from the MAC to an Apple fi (with 
SuperSerial card ) or lic. Includes Apple |! diskette with transfer software plus fully commented SOURCE code. 


MIDI-MAGIC for Apple //c: $49.00 
Compatible with any MIDI equipped music keyboard, synthesizer, organ or piano. Package includes a MIDI-out 
cable (plugs directly into modem port - no modifications required!) and 6-song demo diskette. Large selection of 
digitized QRS player-piano music available for 19.00 per diskette (write for catalog). MIDI-MAGIC compatible 
with Apple Il family using Passport MID! card (or our own input/output card w/drum sync for only $99.00). 


FONT DOWNLOADER & EDITOR: $39.00 
Turn your printer into a custom typesetter. Downloaded characters remain active while printer is powered. 
Use with any Word Processor program capable of sending ESC and contro! codes to printer. Switch back and 
forth easily between standard and custom fonts. Special functions (like expanded, compressed etc.) supported. 
Includes HIRES screen editor to create custom fonts and special graphics symbols. For Apple Il, Il+. //e. Specify 
printer: Apple Imagewriter Apple Dot Matrix, C.ltoh 8510A (Prowriter), Epson FX 80/85, or Okidata 92/192. 
* FONT LIBRARY DISKETTE #1: $19.00 contains lots of user-contributed fonts for all printers 
supported by the Font Downloader & Editor. Specify printer with order. 
DISASM 2.2e : $30.00 ($50.00 with SOURCE Code) 
Use this intelligent disassembler to investigate the inner workings of Apple |! machine language programs. 
DISASM converts machine code into meaningful, symbolic source compatible with S-C, LISA, ToolKit and other 
assemblers. Handles data tables. displaced object code & even provides label substitution. Address-based triple 
cross reference generator included. DISASM is an invaluable machine language learning aid to both novice & 
expert alike. Don Lancaster says DISASM is “absolutely essential” in his ASSEMBLY COOKBOOK. 
The ‘PERFORMER’ CARD: $39.00 ($59.00 with SOURCE Code) 
Converts a ‘dumb’ parallel printer !/F card into a ‘smart’ one. Simple command menu. Features include 
perforation skip, auto page numbering with date & title, lerge HIRES graphics & text screen dumps. Specily 
printer: MX-60 with Graftrax-80, MX-100, MX-80/100 with Graftraxplus, NEC 8092A, C.Itoh 8510 
(Prowriter). OkiData 82A/83A with Okigraph & OkiData 92/93. 
‘MIRROR’ ROM: $25.00 ($45.00 with SOURCE Code) 
Communications ROM plugs directly into Novation's Apple-Cat Modem card. Basic modes: Dumb Terminal, 
Remote Console & Programmable Modem. Features include: selectable pulse or tone dialing. true dialtone 
detection, audible ring detect, ring-back, printer buffer, 80 col card & shift key mod support. 
RAM/ROM DEVELOPMENT BOARD: $30.00 
Plugs into any Apple slot. Holds one user-supplied 2Kx8 memory chip (6116 type RAM for program development 
or 2716 EPROM to keep your favorite routines on-line). Maps into $CnO0-CnFF and $C800-CFFF. 
C-PRINT For The APPLE //c: $69.00 
Connect standard parallel printers to an Apple //c serial port. Separate P/S included. Just plug in and print! 


Unless otherwise specified, all Apple Il diskettes are standard (not copy protected!) 3.3 DOS. 
Avoid a $3.00 handling charge by enclosing full payment with order. VISA/MC and COD phone orders OK. 


RAK-WARE 41 Ralph Road W. Orange NJ 07052 (201) 325-1885 
SCEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 


Page 8.....Apple Assembly Line.....July, 1987......Copyright (C) S-C SOFTWARE 


1760; @eeceeeei sc wess leet eetecescJoce Ss 
11° PICTURE 
00087B- 08 1780 PHP ENTER NATIVE MODE 
00087C- 18 1790 CLC 
00087D- F 13800 XCE 
OO087E- 0 TRG 3 PHP 
00087F= C2 11 1930 REP #$11 CLC, x 
000881- A2 00 00 1840 LDX ##0 For X = 0 to 3197? 
000884- AQ 00 1850 .1 LDA #0 or A = $00 to $FF step $11 
000886- AO 0 1860 .2 LDY ##10 r Y = 10 to 1 step -1 
AOD BD OF 00 20 E1 1870 as ae ve12000,% : 
- ext x 
- ex 
0008 8E iB 1890 DEY Next Y 
OOO88F- DO F 1900 BNE . 
BOO et. BB a M230 ace #311 Next A 
000898 EO 00 7D 1830 CPX ##32000 
= ° ore to this screen 
00089 90 EA ieeo . BCC .1 M t hi 
00089A- 28 1320 PLP RETURN TO EMULATION MODE 
00089B- FB Mohn XCE 
00089C~- 28 1980 PLP 
00089D- 60 Shae RTS 
20 0 @ SE iS CES SOS oan @& es = a> ap a> a» 


Some of Our Other Products 


S-C Cross Reference Utility: A support program which works with the S-C Macro 
Assembler to generate an alphabetized listing of all labels in an assembly 
language source program, showing with each label the line number where it 
is defined and all the line numbers containing references to that label. 
Works with multi-file source programs. The ProDOS version automatically 
follows the .IN or .INB ("include file") directives and assigns a 
code-letter to each included file in the cross reference listing. We 
include the complete source code for this amazingly fast program, in both 
DOS and ProDOS versions, for only $50. 


S-C DisAssembler: An intelligent two-pass disassembler which works in 
conjunction with the ProDOS version of the S-C Macro Assembler. Converts 
files of 6502 or 65C02 machine language programs into meaningful source 
code files complete with labels. Driven by a script you write ina 
convenient "disassembly" language, allowing you to define label names of 
your choice, process all or part of input files, and many other options. A 
built-in option produces comment lines before each label showing all 
reference points to that label. Comes with complete commented source code 
and easy-to-understand documentation, for only $50. 


ProVIEW, by Doug McComsey: A professional tool for "zapping" ProDOS disks and 
memory. On an Apple //c, //e, or //gs in 80-column mode ProVIEW gives you 
a 256-byte window into RAM, ROM, ProDOS files, and disk blocks. You can 
examine, modify, and update any portion of RAM, a file, or a disk block. 
Operates from a series of menu screens much like Appleworks, with complete 
HELP available at every step. Only $20! 
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A+ September Puzzle Solved......eeeeeeeeeeBOD Sander-Cederlof 


The September issue of At Magazine gives the winning solutions 
to the puzzle we solved in our May issue of AAL. Mine didn't 
win, perhaps because I did not send it in. It also gives a new 
interesting puzzle: find an 8-digit number which is the square 
of a multiple of seven of the form “ababbbcc", 


I wrote three different Applesoft programs to solve this 
puzzle, testing different algorithms. Then I converted one of 
them to assembly language. The assembly version finds the only 
answer in the astonishing time of less than 600 milliseconds! 
It also illustrates a few intersting programming techniques. 


In trying to figure out how to efficiently solve this problem, 
I first noticed that only three different digit values occur in 
the answer. The smallest possible number of the form ababbbcc 
is 10100022, and the largest possible answer is 98988877. 
Taking the square root of these two values, I find the smallest 
multiple of 7 to test is 3185 (7 times 455), and the largest is 
9947 (7 times 1421). I can run through all the multiples of 7 
between these two values and test the digits in the square to 
see if they follow the pattern. Here is one way to do that: 


100 FOR X = 3185 TO 9947 STEP 7 

110 N= X * X 

120 A = INT (N / 100000) 

130 Al = INT (A / 100) :A3 = A - Al * 100 
140 A2 = INT (A3 / 10): IF Al = A2 THEN 300 
150 A3 = A3 - A2 * 10: IF Al < > A3 THEN 300 
160 B = ((A2 * 10 + A2) * 10 + A2) * 100 

170 A=N- A * 100000 

180 IF A < BOR A > B + 99 THEN 300 

290 PRINT N® = ( 7 * *X" ) * 2" 

300 NEXT 


Since there are 967 multiples of seven in that range, the 
program above has to test 967 numbers to find whatever 
solutions there may be. It takes abou 51 seconds to find the 
one and only solution. My next approach only has to test 270 
different numbers, so it runs considerably faster (less than 13 
seconds). 


This time I decided to build all possible numbers of the form 
ababbbcc, and then test them to see if they were perfect 
squares of multiples of seven. Here is the program: 


100 FOR A = 10100000 TO 90900000 STEP 10100000 
110 FOR B = 0 TO 9099900 STEP 1011100 
120 FOR C = 1 TO 99 STEP 49 


130 N=A+t+B+C 

140 NN = INT (N / 49) * 49 

150 LO = NN - INT (NN / 100) * 100 

160 IF LO > C THEN 300 

170 Ll = INT (LO / 10): IF Ll < > (LO - Ll * 10) THEN 300 
180 S = INT ( SQR (NN)): IF S * S < > NN THEN 300 
290 PRINT NN" = (7 * “S / 7" ) 7* 2" 

300 NEXT : NEXT : NEXT 
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Lines 100-130 will generate all numbers of the form ababbbOO+C, 
where C is 1, 50, or 99. Line 140 will generate the number N 
smaller than or equal to ababbb0OO+C which is a multiple of 49 
(squares of a multiple of 7 will be multiples of 49). Lines 
150-170 make sure the last two digits are the same, giving the 
number the form ababbbcc. Finally, line 180 checks to see if 
the test number is a perfect square. 


Neither of these two algorithms would be particularly easy to 
convert to assembly language, because of the multiplication and 
division steps needed. Therefore I developed yet another 
method, a modification of the first program above. I realized 
that stepping X by 7 meant that successive values of the 
squares could be formed by addition. If a value X is equal to 
7A, then the next value X is 7A+?7. 


7A 49A*2 
7A+7  49A°2 + 98A + 49 


So the difference between any two successive squares (values of 
N) will be 98A+49. Going a step further, the difference 
between two successive differences will always be 98. For 
example, here are the first four values of X and N, with the 
successive differences: 


dx x N=X*X M=dN GM 
3185 10144225 
7 < > 44639 
3192 10188864 > 98 
Tt > 44737 
3199 10233601 > 98 
7 < > 44835 


3206 10278436 


So, I can write another program which looks a lot like the 
first one above but uses no multiplication to get the next 
value for N. Here it is: 


100 N = 10144225:M = 44639:D = 98:L = 98988877 
110 N= N + M:M = M + D 

120 A = INT (N / 100000) 

130 Al INT (A / 100) :A3 = A - Al * 100 


140 A2 = INT (A3 / 10): IF Al = A2 THEN 300 
150 A3 = A3 - A2 * 10: IF Al < > A3 THEN 300 
160 B = ((A2 * 10 + A2) * 10 + A2) * 100 

170 A=N- A * 100000 

180 IF A < B OR A > B + 99 THEN 300 

290 PRINT N 

300 IF N < L THEN 110 


This version is slow again, taking about 52 seconds to run 
Clear through. However, it will be the fastest one when 
running in assembly language. The assembly listing which 
follows implements the same algorithm, with a few minor 
differences. One key to its speed is that I keep the number N 
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Ram Factor 


Boot any I+, Ie or Ilcs and be up and running your 
Javorite software in less than 1 second. 


No anyone with an Apple II+, Franklin, Laser 128, Apple Ile or IIcs preferring to use Features: 

slots 1 through 7 can now enjoy the speed and performance that they’ve been waiting for. e 256K to 1 MEG on main board. Expansion 
With RamFactor, you'll be able to instantly add another 256K, 512K, ora full 1 MEG on connector for possible further expansion to 

the main board and an expansion connector can address an additional 16 MEG of 16 MEG. 

memory for possible furure expansion. Since virtually all software is automatically e Fully Apple I] Memory Expansion 

compatible with RamFactor, you'll immediately be able to load programs into RamFactor compatible 

for instantaneous access to information. You'll also be able to store more data for larger e Compatible with Apple Ile, I+, IIcs, 

word processing documents, bigger data bases, and expanded spreadsheets. And with the Franklin and Laser 128 

battery back-up option, you can switch on your Apple and your favorite software will e Battery back-up option allows you to tum 

be up and running in less than 1 second! on your Apple and run your favorite 


programs in less than 1 second! 

e Automatically recognized by ProDos, DOS 
3.3, Pascal, and standard CP/M 

e Built-in RamDrive™ software (a true RAM 
disk not disk caching) 

e Systems are directly bootable from Ram- 
Factor if desired 

e Built-in self diagnostic software 


e Allows Apple II+ and Ile to run your 
AppleWorks without buying any 
additional software 

e Accelerates AppleWorks 

e Displays time and date on the AppleWorks 
scteen with any ProDos clock 

e Fits any I/O slot except slot 3 

e Fully socketed and user upgradeable 

The “Instant On” Apple. * Much, much more 


Very Compatible 

All the leading software is already com- 
patible with RamFactor. Programs like Apple- 
Works, Pinpoint, BPI, Managing Your Money, 
Dollars and Sense, SuperCalc 3A, PFS, Mouse. 
Write, MouseDesk, MouseCalc, Sensible 


He, Franklin, or Laser 128 when used with an 
80 column display. RamFactor, no other 
standard slot card comes dose to enhancing 
AppleWorks so much. 


Speller, Applewriter Ue, Business Works, . With the RamCharger 

ReportWorks, Catalyst 3.0 and more. And ; battery backup op- RamFactor with 256K 
RamFactor is fully ProDos, DOS 3.3, Pascal 1.3 AMCHARGER / tion, RamFactor RamFactor with 512K 
and CP/M compatible. In fact, no other slot | will retain pro- RamFactor with 1 MEG 


grams and data RamFactor with 2-16 MEG 

during power RamCharger backup option 

failures or even “Y¥” cable 

when you tum your computer off And (Allows one RamCharger to power two RamFactors.) 
because RamFactor plugs into slots 1-7, its 
the only memory card that can cold boot 
an Apple without using slow floppy or hard 


1-7 memory card is more compatible with 
commercial software. 


AppleWorks Power 

There are other slot 1-7 cards that give 
AppleWorks a larger desktop, but that’s the 
end of their story. But RamFactor is the only 
slot 1-7 card that increases AppleWorks 
intemal memory limits, increasing the maxi- 
mum number of records in the database and 
lines permitted in the word processor, and 
RamFactor is the only standard slot card that 
will automatically load all of AppleWorks into 
RAM dramatically increasing speed and 
eliminating the time required to access the 


Order RamFactor today .. . with 15 day 
disks, An available “Y" cable allows one money back guarantee and our “no hassle” 


five year warranty. See your dealer or call 

(214) 241-6060, 9 am to 11 pm, 7 days, or 

send check or money order to Applied 

Powerful Program Switcher Engineering, MasterCard, Visa and C.O.D. 
With RamFactor, you can organize welcome. Texas residents add 6% sales tax 

memory into multiple work areas and switch | Add $10.00 if outside USA 

between them. Each work area can contain 

different programs and even different operat- 

program disk, it will even display the time ing systems Now you can switch from one a App H H ing” 

and date on the AppleWorks screen with program to another or even switch from lied Engineering 

any ProDos cock. RamFactor will automati: | AppleWorks to DOS 3.3 to CP/M to Pascal to The Apple enhancement experts. 


RamCharger to power two RamFactors. 


cally segment large files so they can be ProDos in under a second And with our as 
saved on 5%", 3¥2'", and hard disks. All this battery back-up option, you can have (214) 241-6060 
performance is available on the Apple II+, permanent storage for up to 20 years. P.O. Box 798, Carrollton, TX 75006 
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in an 8-byte decimal format. This way I do not need to convert 
from binary to decimal for every value in order to test the 
inidvidual digits against the pattern. 


All of the arithmetic is done in on these unpacked decimal 
strings, with 8 digits per value. The variables N and M are 
initialized in lines 1050-1120, by copying in NN and MM. I did 
this so that I could execute the program enough times in 
succession to get a measureable time on my stopwatch. (Lines 
1910-1960 execute the program ten times, and this took about 6 
seconds.) 


The additions to generate the next square and next M-value are 
done by lines 1140-1200, with the help of the ADD subroutine in 
lines 1640-1780. The subroutine assumes the Y-register 
contains the offset from STRINGS of the last (least- 
Significant) digit of one of the addends, and the X-register 
contains the offset for the other addend. The result is stored 
in the string pointed to by the Y-register. Lines 1700-1720 
are kind of neat: they limit each byte to the value of a 
Single digit, and set up the carry for the next digit. 


Lines 1210-1420 compare the value of N with the pattern 
ababbbcc. There are many possible ways to arrange the pattern 
tests, so I just picked one. The order of the tests affects 
the speed a little, but very little. The two tests in lines 
1390-142 are “commented out" because they were not necessary. 
There are no additional values of N rejected because of those 
two tests. In other words, we could have said the pattern was 
abab..cc, where the two dots represent any digit which may or 
may not be the same as any of the other digits, and still we 
would only get one answer. 


Lines 1430-1510 print any values of N which pass all the tests. 
Only one does, but it is fun to experiment with leaving out 
different tests (comment out various lines with BEQ or BNE 
opcodes between 1210 and 1420). Then you get more answeers, 
because you are not being so picky. 


Lines 1530-1580 test the value of N to see if it is still less 
than 99000000. We only have to test the first two digits to 
find this out. If they are both 9, then we are through. 


1919 SOAVE S.PUZZLE 9-87 
FDED- MON.COUT .EQ $FDED 
FDSE- 10n8 MON.CROUT . 3 gEDRD 
fog gar Se re ee eee 

0800- AO 0 1020 LDY #7 Copy initial values for 
0802- B9 A4 08 ako 0 LDA NN,Y N and M 
0805- 99 84 0g 1080 STA N,¢ 
0805- B9 AC 08 1090 LDA MM,Y 
O80B- rf 8C 08 1100 STA M,Y 
O80E- 1110 DEY 
O80F- 10 F1 yee Pe aia 0 

aoe = +- Pewwrereeereweeeoeeasoeeors= 
0811- AO OF 1480 1 LDY #M-STRINGS+7 
0813- A2 0 1190 LDX #N-STRINGS+7 
0815- 20 67 08 a ; P " : ADB 

oom = + YO erence ee eeeeweoeowoeres 
0818- AO 17 1160 LDY #D-STRINGS+7 
O81A- A2 OF — 1190 LDX #M-STRINGS+7 
081C- 20 67 08 1200 ADD 
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1210 #---Check for ababbbec----------- 
O81F- 8A 08 1220 LDA N+6 Get c 
Opa2- CB gp 08 1236 ENE 3. ase ss 
0827- CD B4 08 1250 CMP N “ee ees 
O82A- FO 2C 12 0 BEQ 3 -.. have Cocee eS 
O082C- CD 85 08 1ehe CMP N+1 
O82F- FO 27 1350 P BEQ .3 eee have ac..--cc 
0831- AD 84% 08 1300 LDA N Get a 
0834- CD 85 08 1310 CMP N+1 
a8 3 FO 1F 1320 BEQ 3 ~-- have A2aeee e CC 
0839- CD 86 08 1 Fe CMP N+2 
08 3C- DO 1A ie : a BNE 3 ee not aba...cc 
08 RE AD 85 1380 LDA N+1 Get b 
O8&1=- CD 87 08 1 fe CMP N+3 
0 Kae Do 12 1 0 BNE 3 ee not abab. ca 
1390 #28 CMP N+4 
1400 #88 BNE .3 ~ee not ababb.co 
1410 ##6@ CMP N+5 
1420 #88 BNE .3 ~..-not ababbbcco 
130 #---Print the answePren--o-<-----= 
OB Ng AO 00 1440 LDY #0 
O848- BO 84 08 a8 2 LDA N,Y Next digit 
O84B- 09 BO 1460 ORA #*0*® make it ASCII 
O84D=- 20 ED FD 478 JSR MON .COUT 
oBey- 60 08 «9 CPY #8 
0853- 90 F3 1500 BCC .2 
0855=- 20 8E FD 1510 JSR MON .CROUT 
1520 #---IF N < 99000000 THEN LOOP---- 
0858- 84 08 1390 3 LDA 
085B=- C9 09 1540 CMP #9 
O85D=- 90 B2 1330 BCC .1 
085F- 5 08 1560 LDA N+1 
0862- C9 09 178 CMP #9 
0864- 90 AB 1590 ‘. BCC .1 
0866- 60 18 0 RS © 
1610 Sennen nnn nn nnn nn owner e 
1920 ADD S(Y) TO S(X) 
\8i0 ADD 
0867- AQ 08 1650 LDA #8 DO 8 DIGITS 
0869- 8D BH 08 1660 STA DGT 
086C- 18 1 fo CLC START WITH CARRY CLEAR 
O86D=- BD 84 08 1680 .1 LDA STRINGS ,X 
0870- 79 84 08 1690 ADC STRINGS,Y 
oete aa a3 ve Bee #10 ge IF > 9 
0 i{- E9 Of 1120 SBC #10 .. MODULO’ 10, LEAVE CARRY SET 
0879- 2 08 1 30 .2 STA STRINGS ,X 
tie a 1750 DEX oe onan 
O87E- CE BH 08 1760 DEC DGT 
GeRi- BG Bk °° 1770 Bae ST wns, po wear ror 
1790 TS IS a BREESE CL le ST STEEN 
O884- 01 00 01 eee) sree 
0887=- O04 O4 02 
O88F- 04 O4 0 
0897=- 00 00 00 
apace 43 ae ; 1830 D ~-HS 00.00.00.00.00.00.09.08 98 
O89F- 08 02 0 
O8A2= 00 01 ioeD L -HS 09.08.09.08.02.06.00.01 98, 982,601 
O8A4- 010001. ©” 
O8A7— O4 O4 02 
: tee AG BB AG 1860 NN eHS 01.00.01.04.04.02.02.05 10, 144, 225 
OBAF- O4 O4 06 


July, 1987......Copyright (C) S-C SOFTWARE 


ange fener nnn nen nn enn= 
O8BA- 1980 DGT -BS 1 
0 Pk 42 Of OA 1910 TT LDA #10 DO *T" 10 TIMES FOR TIMING 
O8BT7- 1829 STA 
O8B9- 20 i 08 1 30 1 JSR T 
OBB. C 1940 DEC 0 
op BE D9 Pg 1950 BNE .1 
1960 RTS 
1070 Sonn nc mw meme ww mm wwe owe ow ewe wooo oe= 


Apple IIgs Firmware Reference 


Apple says this book is “for hardware designers and programmers 
who want to work with the system firmware in lieu of using the 
Apple IIgs Toolbox routines to accomplish similar goals.” I 
think that is far too narrow an audience. This is the book you 
need if you want to use the system monitor, the disassembler, 
and the mini-assembler. This is the book you need if you want 
to do any programming with the mouse, the serial ports, the 
interrupts, and more. And I cannot think of any IIgs owners 
who doesn't want at least some of that information! 


This book does not include a commented assembly listing of the 
firmware. In the past Apple has published such listings, but 
they are evidently not planning to do so for the IIgs. It does 
include detailed programming information for all of the 
built-in I/O devices, via the “slot-based" firmware. No detail 
about the hardware for the serial ports or other I/O devices is 
included, just the firmware. I cannot imagine doing without 
this book. I think it will be the one I use the most, because 
it is the one that tells me about how I interact with my 
machine. Next to this will be the IIgs Hardware Reference, due 
from the publisher in a few weeks. 


Acdison-Wesley's price for this 327-page book is $24.95, and it 
will be available at many bookstores. Or, you can order it 
from us for $23, plus shipping. 


Werning to Smart Port ProgrammerS.....ccccccescecceeeTOM Vier 


This is a warning to those of you who may be writing code for 
the new IIgs Smart Port devices. I discovered what I think is 


a surprising and dangerous inconsistency between the Smart Port 
specification and the Apple SCSI Port. 


Recall that the Smart Port used to be called the Protocol 
Converter. On page 128 of the Apple //c Technical Reference 
Manual it shows that the Protocol Convert call with command $04. 
and subcode $04 will eject the disk from the Unidisk 3.5 drive. 
This fact has been published far and wide so that people can 
add code to their own programs to eject that little disk under 
program control. 


Now along comes the SCSI port. One page 33 of the SCSI 
documentation it says that subcode $04 under command $04 does a 
FORMAT of the attached hard disk drive! This surprises me 
since the Smart Port specification has a separate command ($03) 
for FORMAT. 


So the warning is, do not blindly send out command $04 with 
subcode $04. Those subcodes are device-specific, so you have 
te first find out what kind of device is attached to the Port. 
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RamWorks III 


Patented Performance from the Recognized Leader 


With battery backed RAM port, RGB port, increased memory capacity, full software 
compatibility and more compact design, RamWorks III ts a generation ahead. 


RamWorks Ill is the newest 3rd 
generation RAM card for the Apple Ile. It 
incorporates all of the technology and 
improvements that years of experience 
and over a hundred thousand sales have 
given us. By selling more memory cards 
than anyone else and listening to our 
customers, we were able to design a 
memory card that has the ultimate in 
performance, quality, compatibility and 
ease of use. A design so advanced it’s 
patented. We call it RamWorks III, you'll 
call it awesome! 


The AppleWorks Amplifier. 

While RamWorks III is recognized by 
all memory intensive programs, NO 
other expansion card comes close to 
offering the multitude of enhancements 
to AppleWorks that RamWorks III does. 
Naturally, you’d expect RamWorks III to 
expand the available desktop, after all 
Applied Engineering was a year ahead of 
everyone else including Apple in offering 
more than 55K, and we still provide the 
largest AppleWorks desktops available. 
But a larger desktop is just part of the 
story. Look at all the AppleWorks en- 
hancements that even Apple’s own card 
does not provide and only RamWorks I 
does. With a 256K or larger RamWorks 
Ill, all of AppleWorks (induding printer 
routines) will automatically load itself into 
RAM dramatically increasing speed by 
eliminating the time required to access 
the program disk drive. Switch from 
word processing to spreadsheet to data- 
base at the speed of light with no wear 
on disk drives. 


Only RamWorks eliminates Apple- 
Works’ intemal memory limits, increasing 
the maximum number of records avail 
able from 1,350 to over 25,000. Only 
RamWorks increases the number of lines 
permitted in the word processing mode 
from 2,250 to over 15,000. And only 
RamWorks offers a built-in printer buffer, 
so you won't have to wait for your 
printer to stop before returning to Apple- 
Works. RamWorks even expands the 
clipboard. And auto segments large files 
so they can be saved on two or more 
disks. You can even have Pinpoint or 
MacroWorks and your favorite spelling 


| checker in RAM for instant response. 


RamWorks, nothing comes close to 
enhancing AppleWorks so much. 


The Most Friendly, Most 
Compatible Card Available. 
Using RamWorks III couldn’t be easier 
because it's compatible with more off 
the-shelf software than any other RAM 
card. Popular programs like AppleWorks, 
Pinpoint, Catalyst, MouseDesk, Howard- 
Soft, FlashCalc, Pro-Filer, Managing Your 
Money, SuperCalc 3a, and MagiCalc to 
name a few (and all hardware add on’s 
like ProFile and Sider hard disks). Ram- 
Works is even compatible with software 
written for Apple cards. But unlike other 
cards, RamWorks plugs into the Ile 
auxiliary slot providing our super sharp 
80 column text (US. Patent #4601018) in 
a compketely integrated system while 
leaving expansion slots 1 through 7 
available for other peripheral cards. 
RamWorks Ill is compatible with all 


Apple IIe’s, enhanced, unenhanced, 
American or European versions. 


Highest Memory Expansion. 
Applied Engineering has always of 
fered the largest memory for the Ile and 
RamWorks III continues that tradition by 
expanding to 1 full MEG on the main 
card using standard RAMs, more than 
most will ever need (1 meg is about 500 
pages of text)...but if you do ever need 
more than 1 MEG, RamWorks III has the 
widest selection of expander cards avail- 
able. Additional 512K, 2 MEG, or 16 
MEG cards just snap directly onto Ram- 
Works II by plugging into the industry's 
only low profile (no slot 1 interference) 
fully decoded memory expansion con- 
nector. You can also choose non-volatile, 
power independent expanders allowing 
permanent storage for up to 20 years. 


It Even Corrects Mistakes. 

If you've got some other RAM card 
that’s not being recognized by your 
programs, and you want RamWorks II, 
you're in luck Because all you have to 
do is plug the memory chips from your 
Current card into the expansion sockets 
on RamWorks to recapture most of your 
investment! 


The Ultimate in RGB Color. 

RGB color is an option on RamWorks 
and with good reason. Some others 
combine RGB color output with their 
memory cards, but that’s unfair for those 
who don't need RGB and for those that 
do. Because if you don’t need RGB 
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Applied Engineering doesn’t make you 


; buy it, but if you want RGB ourput 
_ you're in for a nice surprise because the 


RamWorks RGB option offers better 
color graphics plus a more readable 80 
column text (that blows away any 


| composite color monitor). For only $129 
| it can be added to RamWorks giving you 
a razor sharp, vivid brilliance that most 


claim is the best they have ever seen. 
You'll also appreciate the multiple text 
colors (others only have green) that 


~ come standard But the RamWorks RGB 
‘ Option is more than just the ultimate in 
! color output because unlike others, it’s 


fully compatible with all the Apple 
standards for RGB output control, mak- 


ing it more compatible with off-the-shelf | 
| powerful auxiliary slot memory card 
' available for your Ile, and J rate it four 


software. With its FCC certified design, 
you can use almost any RGB monitor 
because only the new RamWorks RGB 
option provides both Apple standard and 


' IBM standard RGB outputs (cables in- 


cluded). The RGB option plugs into the 
back of RamWorks with no slot 1 inter- 


RGB Option a 


ference and remember you can order 
the RGB option with your RamWorks or 
add it on at a later date. 


True 65C816 16 Bit Power. 

RamWorks II has a built-in 65C816 
CPU port for direct connection to our 
optional 65C816 card The only one 
capable of linearly addressing more than 
1 meg of memory for power applica- 
tions like running the Lotus 1-2-3™ 
compatible program, VIP Professional 
Our 65C816 card does not use another 
slot but replaces the 65C02 yet maintains 
full 8 bit compatibility. 


| ing’s RamWorks is a boon to those who | 
_ must use large files with AppleWorks..1 | ° 
' like the product so much that I am : 
| buying one for my own system.” inCider | 


i q 


| pressed by RamWorks’s expandability, ° 
| 
| 
| 


~ power and speed that it adds to any Ile. 


Endorsed by the Experts. 
A+ magazine said “Applied Engineer- 


| e Built-in super sharp 80 column display, | 
(US. Patent #4601018) 
e Expandable to 1 MEG on main card 
Expandable to 16 meg with expander 
cards, with NO slot 1 interference 

e Can use 64K or 256K RAMs 

Powerful linear addressing 16 bit 
coprocessor port 

| e Automatic AppleWorks expansion up 
to 3017K desktop 

Accelerates AppleWorks 

Built-in AppleWorks printer buffer 

The only large RAM card that’s 100% 
compatble with all Ile software 
RamDrive™ the ultimate disk emula- 
tion software induded free 

Memory is easily partitioned allowing 
many programs in memory at once 

e Compatible, RGB option featuring ultra 
high resolution color graphics and 
multiple text colors, with cables for 


magazine said “RamWorks is the most - 


‘T wanted a 
| memory card for | | 
| my Apple that was | ¢ 
fast, easy to use, 
and very compat- || e 
| ible: so I bought | 
~ RamWorks.”’ |e 


Steve Wozniak, the creator 
of Apple Computer 


stars..For my money, Applied Engineer- 


ing’s RamWorks is king of the hill” both Apple and IBM type monitors 
Apple experts everywhere are im- e Built-in self diagnostics software 
Lowest power consumption (US. 
versatility, ease of use, and the sheer Patent #4601018) 
e Takes only one slot (auxiliary) even 
when fully expanded 


Socketed and user upgradeable 
Software industry standard 
Advanced Computer Aided Design 
| e Used by Apple Computer, Steve 

| Wozniak and virtually all software 

| 


companies 

Displays date and time on the Apple- 
Works screen with any PRO-DOS 
compatible clock 

e Much, much more! 


RamWorks Ill with 64K $179 
RamWorks Ill with 256K $199 
RamWorks Ill with 512K $249 
RamWorks Il! with 1 MEG $329 


RamWorks Ill with 1.5 MEG $489 

RamWorks lll with2to16MEG CALL 

65C816 16 Bit Card 

RGB Option 

Optional Software: 

Pinpoint with RAM 
Enhancement Software 

VIP Professional 


| RamWorks Il. The industry standard |. 

Quality and Support of the {; memory expansion of the Apple Ie. 
Industry Leader ORDER YOUR RamWorks III TODAY. 

RamWorks III is from Applied Engi- See your dealer or call (214) 241-6060, 
neering, the largest, most well supported | 9 a.m. to 11 p.m., 7 days, or send check or 
manufacturer of Apple peripherals and money order to Applied Engineering. 
the inventor of large RAM cards for the MasterCard, Visa and C.O.D. welcome. 
Apple. With our 5 year no hassle Texas residents add 6%4% sales tax. Add 
warranty and outstanding technical sup- | $10.00 if outside USA 
port, you're assured of the most trouble 
free product you can buy. 


Its Got It All 


e 15 day money back guarantee 
e 5 year hassle free warranty 


With a RamWorks in your Apple, youl 
make IBM PC’s and ATs look like 
slowpokes. 


AK Applied Engineering 
P.O. Box 798, Carroliton, TX 75006 
(214) 241-6060 
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Apple IIgs ProDOS-16 Reference 


Apple says this is "a manual for software peveteper ss advanced 
programmers, and others who wish to understand the technical 


aspects of the Apple IIgs operating system.“ Here is a brief 
run-down of the contents: 


1-5 -- About P16 (Files, Memory Management, External Devices, 

and the Operating Environment) 

6 -- Programming with P16 (Revising a ProDOS-8 Application, 
and Using the Apple IIgs Programmer's Workshop) 

7 -- Adding Routines to P16 (Interrupt Handlers) 

8-13 -- Making P16 Calls (Complete description of all of the 
MLI calls supported by P16) 
14-17 -- The System Loader (How to use the system loader to 

load and relocate programs, including a description of 
the 16 System Loader Calls.) 


Appendix A -- P16 File Organization (Exactly the same as 
ProDOS-8, except that more file types are defined) 

Appendix B -- Comparison of Apple II Operating Systems 

Appendix C -- The ProDOS 16 Exerciser (Tells about the disk 
which comes with the book) 

Appendix D -- System Loader Technical Data (Most of the 
information about the Object module format expected by 
the System Loader. More detail will be available 
someday in the "Apple IIgs Programmer's Workshop 
Reference".) 

Appendix E -- Complete list of Error Codes for P16 and the 
System Loader 


There is a good index, as well as a glossary. And to cap it 
off, a rather complete Reference Card. The card is printed 
with major headings in red ink, to make it easier to locate 
items ina hurry. It totals eight full-size pages, and 
includes all of the MLI calls, System Loader calls, and Error 
Codes. Most of the info you need to understand and build file 
description blocks is also included. 


All of the important information is here. However, there are 
no programming examples. I suspect there were not any good 
ones available at the time the book was written. We still feel 
the need for a book like Gary Little's “Apple ProDOS Advanced 
Features” (which we cannot get anymore) which would lead us 
through step-by-step in writing ProDOS-16 programs. Gary's 
book was for the old ProDOS-8, but he or someone should bring 
out a ProDOS-16 book like it. We also wish Don Worth and 
Pieter Lechner would give us the equivalent to “Beneath Apple 
DOS“ and “Beneath Apple ProDOS"*. This is probably asking too 
much, considering the size of the job. 


The publisher's price for this 338-page book is $29.95, and it 


will be available at most bookstores. Or, you can order it 
from us for $27, plus shipping. 
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Another ProDOS-8 Bug in the IIgs.........-Bob Sander-Cederlof 


Back in December of 1986 we noticed that a target file written 
from the ProDOS S-C Macro Assembler when running on a IIgs 


contained garbage from locations $9B through SFF of every page 
of the file. We patched the Assembler at that time and made it 
work correctly, blaming the new version of ProDOS. 


The problem seemed to be related to the fact that target file 
processing used a one-byte data buffer at location SOO9A (yes, 
in page zero). Now, there is nothing in any ProDOS 
documentation warning against using a data buffer in page zero. 
Furthermore, ProDOS does not return any error code for such a 
buffer. I assume, and I still think I am correct, that the 
designers of ProDOS expected this to be legal. Nevertheless, 
it does not work correctly in the IIgs. 


It turns out ProDOS was only indirectly at fault. Both the old 
and the new versions of ProDOS-8 show the same failure, but it 
is due to the 65816 processor rather than any changes to the 
ProDOS code. 


The code at fault is the subroutine which transfers bytes of 
data from the caller's data buffer into the file buffer. This 
subroutine is at $F326 in ProDOS 1.1.1; it is at $F311 in 
versions 1.2, 1.3, and 1.4. The file buffer is the one 
specified when MLI was called to OPEN the file. (The one that 
always has to begin on a page boundary.) 


This subroutine uses pointers at $4E,4D and $4C,4D to access 
the data buffer and file buffer, respectively. To simplify 
indexing, a trick is used. It is the trick that causes it to 
fail with pagezero data buffers in a IIgs. 


A subroutine at S$F110 (in version 1.1.1) or SFOF8 (later 
versions) sets up the two pointers. The pointer to the data 
buffer is modified to point some distance BEFORE the actual 
data buffer. The distance is equivalent to the low-order byte 
of the current file MARK. This way the same Y-register value 
can be used to index both the data and file buffers. Except in 
a IIgs, when the data buffer is in page zero. 


For example, here are the data buffer pointer and Y-register 
values for three cases that might occur during a “.TF" write: 


data buffer at SOO9A 
file buffer at $7C00 

eff.addr eff.addr 
mark S4E,4F Y-reg non-IIgs IIgs 


$xx99 $0001 $99 SOO9A $00/009A 
Sxx9A $0000 SOA SOO9A $00/009A 
Sxx9B SFFFF S9B SO09A $01/009A 


Notice that the last value on the last line has bank 1, rather 
than bank 0! For an explanation of how this happens, see the 
last paragraph on page 119 of “Programming the 65816" by Eyes & 
Lichty. Whenever an indexed instruction specifies a 16-bit 


Apple Assembly Line.....July, 1987......Copyright (C) S-C SOFTWARE.....Page 19 


address and assumes the data bank as its bank, then, if the 
index plus the base exceeds SFFFF the effective address will be 
in the next bank. (This allows data tables to straddle bank 
boundaries.) 


What happens then, during a write? All bytes from $xx00 
through $xx9A of each 256 bytes (in the case of my .TF 
processor) are written correctly. Bytes from $xx9B through 
SxxFF are taken instead from bank 1, location S$009A (the AUX 
bank). Whatever data exists there will be written on the file. 


I wanted to test out my theories, so I wrote a quick and dirty 
little program to OPEN a file, WRITE 256 data bytes on it, and 
CLOSE it. I ran it using both versions 1.1.1 and 1.4 of 
ProDOS-8, and on both an Apple //e and a IIgs. Both versions 
of ProDOS worked correctly on the //e, and both failed on the 
IIgs. 


My test program is so “quick and dirty” that you have to CREATE 
the file directly before running the program. If you want to 
try it, type "CREATE TESTFILE,TTXT* before running the program. 
Then to look at the data, type “BLOAD TESTFILE,A$2000,TTXT" and 
use the monitor to print out the contents of $2000-20FF. You 
may also need to change the pathname to that of your test disk. 


By the way, the very same problem exists for READ calls using a 
data buffer in page zero. For example, using a one-byte buffer 
at $009A would cause all bytes within the file which are at 
posiitons $xx9B through $xxFF to stored at $01009A in a IIgs. 
Apparently nobody has tried this yet. 


The current ProDOS version of the S-C Macro Assembler works 
correctly in the IIgs. There have been three changes to make 
this possible. First, we changed to the most recent release of 
the PRODOS file. Second, I moved my .TF buffer out of page 
zero. Third, I modified the "$"* monitor section to work with 
the new IIgs monitor. (This version still works in all older 
Machines aS well.) If you have recently acquired a IIgs and 
need an upgrade to your S-C Macro Assembler, let us know. 


Don't you suppose that there are more programs out there 
besides ProDOS which could stumble over this difference in the 
way indexing works? And more besides our Assembler which will 
stumble over this quirk in ProDOS? Be wary. 


0 
vasa ; TEST WRITING FROM A BUFFER IN PAGE ZERO 


1030 See e cases one cece see coo coee 

B- 1080 DATABUF .EQ $9B 

FOO- 1050 MLI.  .EQ $BF00 
FDDA- 1060 PRBYTE .8Q $FDDA 

1080 T 

0800- 20 00 BF 1090 JSR MLI OPEN THE FILE 

0803- C8 2A 08 1100 DA #$C8, IOB. OPEN 

0806- BO 1F ‘1110 BCS .99 ERROR 
O808- AD 2F 08 1120 LDA 0.REF | GET THE REFERENCE NUMBER 
O80B- 8D 31 08 1130 STA W.REF 

O80E- A9 00 4«20«1150'téti‘(‘< (2Lzé z x! WRITE $00...$FF ON THE FILE 
obies ROO Re a SSR 

0815~- CB 30 08 1160 ° .DA #$CB, IOB. WRITE 
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17 Meglie/1Meglic 


Want the best & easiest-to-use (most support) RAM card on 
the market — at the best price? Buy Checkmate Technology’s 
State-Of-The-Art MULTIRAM RGB RAM CARD” from us 
w/BATTERY BACKED-UP RAM options that save pro- 
grams like AppleWorks for years! FAST CHEAP RE- 
PLACEMENT FOR HARD DISKS, USER EXPANDABLE 
TO 17 MEGS, (100%) compatible w/all 3rd party software/ 
hardware, 65C816 option ($147), sharp 80 columns/Double 
Hi-Res, & FREE RGB! Direct substitute for Ramworks {-1iI™ 
(we think it’s better) by Applied Engineering (also known as 
Preferred Computing) or Apple 80 col cards, has a 5 YR 
WARRANTY, 15 day money back guarantee, & FREE 
AUTOMATIC SOFTWARE UPDATES ONLY FROM US! 


MultiRam RGB expands to 1 Meg + optional BATTERY 
PROTECTABLE MuiltiRam Pius piggyback expandable to 
16 Meg's. MultiRam lle expands to 768k. The software & 
manual is the best & easiest-to-use on the market — without 
exception! 


FREE APPLEWORKS EXPANDER SOFTWARE W/EVERY 
CARD — loads ALL versions of Appleworks (in 30 seconds w/ 
AW 2.0), even printer routines, runs faster, Desktop 2048k, 
23,000+ records & 4,800+ word proc lines, segments |g files 
onto multiple disks! FREE AW TIME/DAY/DATE ON-SCREEN 
w/ clock, AUTO-COPY TO RAM, PRODOS/DOS 3.3. RAM 
DISK & TEST. Optional CP/M & Pascal Ram disks ($20/ea)! 


MultiRam MultiRam 
RGB Card ile Card 
. 129. 

157. 

.. 187. 

. 212. 


64k 
320k 
576k 
832k 
1024k 


MultiRam 
MultiRam 
MultiRam 
MultiRam 
MultiRam 
MultiRam 
Pius Piggyback 
MultiRamPlus ... 219. ... 
MultiRam Plus ... 269. ... 
MultiRamPlus ... 316. ... 
1024k MuiltiRamPlus ... 359. ... 
2-17 meg MultiRamPlus ... Call ... 
Battery/AC Kit (for Plus) ... 36.... 


256k 
512k 
768k 


WHY BUY FROM COIT VALLEY COMPU- 
TERS RATHER THAN SOME MAIL ORDER 
HOUSES? Only we offer a 15 day MultiRam 
complete money back satisfaction guaran- 
tee, extra software, more support, free auto- 
matic software updates, free 64k w/ each 
256k/512k/768k Ille/RGB card. We know the 
products, & stock them for fast shipping! CALL 
FOR SUPPORT, QUESTIONS, PRICES, DIS- 
COUNTS. SCHOOLS & GROUPS WELCOME. 


Checkmate Technology’s MuitiRam CX card easily ex- 
pands your lic to 640k and has a CX+ Piggyhack to add 
another 51 2k (1152k total)! It's 100% compatible with all lic 
software/hardware & upgradable with a 65C816 kit ($95) — 
all at about 50% less power than Z-RAM™! Has the SAME 
FREE SOFTWARE/UPDATES & 5 YR WARRANTY AS lie 
CARDS. Buy a C-VUE fiat panel display for $287 w/ 512k 
or greater card. 


256k MULTIRAM CX 
512k MULTIRAM CX 


256k MULTIRAM CX+ 
512k MULTIRAM CX+ 


1200 Baud lic Modem (add $20 for cable) . 147. 
Clip-on lic Rechargable Battery 

lic Flat Panel Display (w/ 512k > Mram) .... 

lic System Clock 


Cermetek 1200 internal modem lle/l+/lgs . 148. 
(+ FREE Source subscription/ VT 100 Shareware/ 
ASCII Express & ProTERM™ Setup Instructions) 


Slot 1-7 Ram Card for ll+, ile, Laser 

ProAPP 20 Meg Hard Disks (+ FREE software) ... 
Apple ile Enhancement Kit 

Apple ligs 

Apple 3.5 800k Unidrive (Ile/lic/ligs) 

Super Serial Compatible Card 

RamPak 512k gs RAM card 

Apple Compatible Drive Ile/Il+ (Ilgs/lic + $19) ... 
Clockworks Clock (Thunder/TimeHO™ compat) ... . 84. 
13” RGB Monitor w/ cables (req. RGB card) 
Heavy Duty Power Supply Ii/li+ /lle 

ile Programmable Numeric Keypad 

System Saver Fan (I1/li+ /tle) 

Uninterruptable Power Supply 250 watt 


AutoWorks (Best AW Macro + more) 

FontWorks (Best AW sideways/Fonts & more) .... 
Pinpoint Program 

Pinpoint Document Checker (Best Speller) 

Copy ll Pius 7.3 (Best ProDOS Utility) 

ProTERM Modem Software 

ASCll Express Modem Software 

VIP Professional (Lotus Clone. Specify Comp) ... 


Terms: Add $4-Ground or $6-Air shipping & phone # toeach U.S. 
MultiRam card order (foreign orders/FPO/APO extra). Add 3% for 
MasterCard/Visa/Am Exp (include expir date) & P.O.’s. For fast 
delivery send Cashier’s/Certified check/Money Order. C.O.D. 
(add $5) & personal checks accepted (allow 16 days). Tex res add 
7 ¥4% tax. Software non-returnable. 

Ordering: PRINT Name & address, Res & Bus phone, credit card 
name/number/expir date where appropriate, qty/description/ 
price/shipping charges if known. Call for questions. 


Autoworks, Ramworks lil/Timemaster | H.O./Z-ram. respective trademarks of Software Touch, Applied 
Engineering. Prices subject to change. 


14055 Waterfall Way 
Dallas, Texas 75240 


COIT VALLEY COMPUTERS 
(214) 234-5047 
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0818- BO OD ~—«-1190 BCS .99 ERROR 
OB1A- E6 9B «1200 INC DATABUF 
OB1C- DO FH 1210 BNE .1 
081E- 20 00 BF 1230 ~ JSR MLI 
0821- CC 38 08 12h0 'D #$CC, IOB. CLOSE 
O824- BO 01 ~=—«:1250 BCS .99 
0826- 60 1260 , RTS 
0827- 4C DA FD 1240 .99 JMP PRBYTE PRINT THE ERROR CODE 
1300 IOB. OPEN 
O82A- 03 1310 DA #3 
O82B- 3A 08 1320 DA PATHNAME 
O82D- 60 09—Cés« 1 30 A FILEBUF 
O82F- Fe O.REF BS 
1360 IOB.WRITE 
ge oer ef 
SH PB HAgR Bg parame 
o é 1410 ACTLEN “BS 2 
1430 IOB. CLOSE 
08 38- 01 14 DA #1 
0839- 00 1450 “DA #0 
1470 PATHNAME 
083A- OE 1480 A #PSZ-1 
Heo ay 
CHE: 
O847- Wc 45 ~~ 1490 .AS "/TEST/TESTFILE* 
OF- 1500 psz_ EQ. #-PATHNAME 
084 9- 1520 .BS #+255/256#256-® FORCE PAGE BOUNDARY 
0900- 1530 FILEBUF’ .BS 512 FOR FILE BUFFER 


Enter Soft  sasic-tike Macros for the S-C Macro Assembler. These macros are 
‘Integer Basic Macros which can perform most of the standard Basic 
commands using 8/16/32/64 bit manipulation. Induded area set of 
graphic commands to perform block graphics and other Hi-Res 
Animation. Available in either DOS 3.5 or ProDos Format. Either one 
for $30.00 or BOTH for $50.00. 


2 Shape A shape table program unlike any other program you have ever run. 

Table This one is completely set up in a logical manner. All disk operations 
are under one section. All editing functions are contained in one 

Bro gram: place. All Hi-Res functions are in one place. The entire source code 
is included to allow you to modify it as you need to! The DOS 3.3 
Version is only $20.00 - AND 80 18 THE PRODOS VERSION!!! Both 
Versions for only $30.00. ORDER YOURS TODAY!!! 


N 


To Ordser: Send check or Money Order To: Upgrades for EnterSoft from DOs 
5.3 to ProDos is $20.00. Get you. 
Mark Manning today! : 


c/o Simulacron 1/Baggy Games 
P.O. Box 591894 Thanks Everyone For Your 


Houston, Tx 77259-1894 Comments and Support! 
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EXEC and INPUT Bug in BASIC.SYSTEM........BoOb Sander-Cederlof 


Michael Wertheim of Plantation, Florida wrote to Open Apple 
pointing out that Negative numbers can be read into an 
Applesoft program from the keyboard, or from an OPEN file, but 
not EXEC'd. Numbers that begin with a digit, a decimal point, 
Or a plus sign work fine. 


Open-Apple verified that Michael was correct. Under DOS 3.3 it 
works correctly, but under ProDOS you get a SYNTAX ERROR when 
you try to use EXEC to feed file-based data to an INPUT state- 
ment, and the line begins with a minus sign. They suggested 
using a string variable, and said that doing so made it work. 

I tried that and found it did not work. Here is a listing of 
the program I used to test it out. 


100 DS = CHRS§ (4) 

105 PRINT DS$*CLOSE “ 
106 PRINT D$"“OPEN TT" 
107 PRINT D$*CLOSE* 
108 PRINT D$*DELETETT“ 
110 PRINT DS$*OPEN TT" 
120 PRINT DS$*WRITE TT" 
130 PRINT 100: PRINT "-123": PRINT 145 
140 PRINT DS$*CLOSE" 
200 PRINT D$*EXEC TT* 
210 INPUT A 

220 INPUT B 

230 INPUT C 

240 PRINT A,B,C 


I tried various things, but none of them made it work. I 
thought maybe inserting an extra space before the minus sign 
would fix it, but it did not. 


“Maybe BASIC.SYSTEM thinks the minus sign is a 
command. * 


Then I thought, 
ProDOS '-filename' 


I tested my idea by changing the variable B to BS, and changing 
line 130 to 
130 PRINT 100 : PRINT "-ABC" : PRINT 145 


Sure enough, when I ran it with those changes inatead of SYNTAX 
ERROR I got PATH NOT FOUND. 


So, the bug is caused by the fact that BASIC.SYSTEM grabs and 
interprets the EXECed line before the Applesoft INPUT statement 
gets a chance. 


Can you imagine the disasters this could cause? What it you 
were reading into a series of strings, and one of them happened 
to be "DELETE V.I.F." (where V.I.F. means Very Important File)? 


The moral of the story is, DO NOT use EXEC to get data for 


INPUT statements. Use OPEN and READ, get your INPUT, and then 
use CLOSE. 
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New Advice 


Open-Apple's Tom Weishaar's monthly newsletter for knowledge- 
able Apple li users. It's thin but packed tight with Apple H lore, 
humor, letters, tips, advice, and solutions to your problems. 
Compared to other Apple || publications, Operm-Apple has the 
highest new-idea-per-issue ratio, the clearest writing, the funniest 
cartoons, the longest index, the only warranty (all your money back 
if you're not satisfied), and it takes up the least shelf space. The only 


eaeaamueameoenmmeeameummeaeamweemeeme em PF eee ee eee eae © eee 2 oe 


thing it doesn't have is the most subscribers. Yet. 


ll cue #13 


When you specify information about your 
printer, AppleWorks asks whether your printer 
supports top-of-page (form feed) commands. 
Almost all printers do. However, you'll find 
that with many printers, including the Image- 
Writer, the page length function within Apple- 
Works will not work correctly unless you 
specify “no” for “accepts top-of-page com- 
mands.’ For much more about dealing with 
printers, see our November 1985 special 
issue: Solving Printer Problems. 


N.Y. 132 17 


P.O. Box 6331, Syracuse, 


O Yes, here's my $24 for 12 issues. 

O Maybe, send mea couple of issues 
and bill me. If | don't pay, cancel 
my subscription at no cost to me. 

O No, but send me information on your 
indexed volumes of back issues. 


From our fan mail: 


We bought AppleWorks for the DA's office 
but couldn't get it to support legal-length 
forms. Your tip about AppleWorks’ “accepts 
top-of-page commands” foible really saved 
the day here in Weatherford and throughout 
the county of Parker. You sure made the 
D.A’s bunch happy. Lord heip the poor soul 
who ever gives you a hot check in Parker 


County. 
Gary Maddox 
Weatherford, Texas 


Visa/ Mastercard 
toll-free order line: 


Ad code: MA73 


Allow 4 to 6 weeks for delivery of first issue. Free airmail worldwide. 


1-800-445-4943 


You probably already know that 
Computers Need Maintenance! 


. But did you 
know that with 
Intelligent Tools 
your computer can 
maintain and 
diagnose itself? 


MASTER DIAGNOSTICS. 


Master Diagnostics provides all 
of the tools and knowhow necess- Expert Opinions 
ary so that anyone can do monthly 
maintenance duties. Calibrating 
disk drive speed, cleaning drive 
heads, checking track alignment or 
just adjusting your monitor to peak 
clarity ts a snap. 

In addition to the maintenance 


Nibble magazine says, “This 
program should be in the library of 
every Apple user”. Howard Sams 
Tech Manual, Apple Orchard, InCider 
Popular Computing, and the Apple Ii 
Review have ail awarded Master 


routines, extensive diagnostic pro- Diagnostics with trinle AAA ratings. 
cedures are available at the touch Conccners Gide chose sian 
ofa key. With our new diagnostic Diagnostics as one of the best 


construction set; you can create 
peripheral diagnostics for any 
device card. Problems are diag- 
nosed down to the chip level and 
tests will report: what's right, what's 
wrong, what to do and how to do at. 
Not just pass-fail type exams! 

The user manual is easy to un- 
derstand and is packed with money 


programs for 1985. Used by Apple 
service centers world-wide. 


WHEN ORDERING SPECIFY: 
version: @ Il+, @ //e or @ //c 
Master Diagnostics - $65.00 r6.1 

with Head Cleaning Kit - $75.00 


saving UDOT information, The Dive eiayees gore 238-25 
rive Analyzer tests and calibration , 
routines alone will pay for Master Visa, MC, COD, School PO's 
Diagnostics after using it just once. Call Free 1-800-835-2246 


NIKROM 
Technical Products, Inc. 
176 Fort Pond Road ¢ Shirley, MA. 01464 


Upgrades - retun 


Appie Diagnostics 
diskette and $20.00 


Since 1979 
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Signed and Unsigned Comparisons..........eBob Sander-Cederlof 


Judging from a lot of the programe I read in magazine or 
purchase and then disassemble, there are a lot of people who 


have not learned the EASY ways to compare two values in the 
6502. 


One reason may be that other microprocessors do things 
d:fferently. Perhaps a programmer adept in Z-80 had to quickly 
learn the 6502 for a particular programming assignment. 


Another factor may be the confusing write-ups in various 
manuals and magazine articles of the past. One in particular I 
re-read yesterday was specifically written to clear up the 
confusion, but someone changed one letter in every listing, 
changing a BVS opcode to BVC, thereby destroying every example. 
I hope that I do not add any confusion today! 


There is also confusion caused by the very design of the 6502. 
There is no opcode in the 6502 for “branch if less than", or 
“branch if greater than or equal“. If the CMP or SBC opcode is 
used to do the comparison, and if the values being compared are 
considered to be unsigned magnitudes, the BCC and BCS opcodes 
can fulfill these functions. Consequently many 6502 assemblers 
include BLT and BGE mnemonics which are simply aliases for BCC 
and BCS. 


The previous paragraphs mentioned “unsigned magnitudes". 

Memory locations simply hold 8-bits of data. An individual 
byte may be considered to be an ASCII character, a two digit 
decimal number, a binary number with no sign of magnitude 
between 0 and 255, a signed binary number between -128 and 
+127, or anything else the programmer desires. Obviously it 
Makes a difference. You cannot use the same methods to compare 
unsigned magnitudes, for example, as you would to compare 
Signed values. 


Equality Comparisons 


Let's start with the simplest case. Suppose you have two 
Single-byte values and you want to compare them to see if they 
are equal or not. Believe it or not, even this is not 
cut-and-dried. One of the values is in a variable called LEFT, 
and the other in RIGHT. Here is one way to do the test: 


LDA LEFT 

CMP RIGHT 

BEQ L.EQ.R 

wee here if LEFT not equal RIGHT 


The comparison is done in this method in the A-register. I 
could just as well have used LDX and CPX to do the comparison 
in the X- register, or LDY with CPY to do it in the Y-register. 
I could also make the third line BNE L.NE.R, and let the code 
fall through to the L.EQ.R code. 
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You can also use the SBC opcode to compare for equality, 
although it is not as efficient since you have to start by 
setting Carry: 


SEC 

LDA LEFT 
SBC RIGHT 
BEQ L.EQ.R 


Using SBC, CMP, CPX, or CPY to compare two bytes may have an 
undesirable side effect in your code. These opcodes also may 
change the Carry status bit. If you have important information 
in C, you may want to use a different method. The EOR 
(exclusive-or) opcode will generate a zero value if and only if 
the two operands are equal. Therefore you can use: 


LDA LEFT 
EOR RIGHT 
BEQ L.EQ.R 


This reminds me of a common error in 6502 code. Some 
microprocessor do not set the EQ/NE status unless you use a 
Specific comparison opcode. The 6502 does it after any opcode 
which puts a value in a register. Over and over I have seen 
code like this: 


SEC 

LDA LEFT 
SBC RIGHT 
CMP #0 

BEQ L.EQ.R 


That CMP #0 is totally wasted. (Another waste I have 
frequently seen is setting or clearing Carry before a CMP 
opcode. You need it before ADC and SBC, but it is useless 
before CMP.) 


What if LEFT and RIGHT are 16-bit variables? Then you can do 
it this way: 


LDA LEFT 
EOR RIGHT 
BNE L.NE.R 
LDA LEFT+1 
EOR RIGHT+1 
BNE L.NE.R 


What if LEFT and RIGHT are 8-bit variables, but I only want to 
check certain bits for equality with the bytes, not all bits? 
I have another variable, MASK, which has l-bits in those 
positions which I want to check: 


LDA LEFT 
EOR RIGHT 
AND MASK 
BEQ L.EQ.R 
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Global communications. 
Down-to-earth price. 


$219 
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Introducing the Datalink” modem. 
Get instant access to networks and databases 
—plus network memberships and discounts worth $177.95! 


Now you can tap into a world of information — without 
draining your resources. Our Datalink" modem lets your Apple 
IIGS, He or 11+ communicate with other computers, download 
free software from networks and bulletin boards, access 
database services and more. For a remarkably low price. 


The world at your fingertips. 

With the Datalink modem, you'll be able to draw informa- 
tion from thousands of databases. Send and receive electronic 
mail — even overseas. Join clubs and bulletin boards to 
exchange software or solve computing problems with other 
Apple users. Download free public domain software. And 
share files with personal computers and mainframes. 

There’s nothing missing 

on Datalink. 

Unlike the Smartmodem® 
Datalink comes with its own easy- 
to-use communications software 
in ROM and on disk that supports 
macros, file transfers, on-line 
time display, data capture and 
datascope mode. The software 
also allows you to store hundreds 
of phone numbers for auto dial- 
ing and log on. 

Because Datalink is 100% 
Super Serial Card compatible, you 
can also run virtually all other 
communication software, including 
Point-to-Point, Apple Access and 
ASCII Express, to name a few. 


Fits any slot 
(even with fan) 


Applied 
Engineering 
Datalink 


$439 
| Max. transmission rate_| 


arranty period 5 years 
at no charge 


Software included a a 


Hayes AT 
command set YES YES 


[Helpscreens | YES | NO 


On-board 
telephone jacks 


The compact design allows Datalink to fit in any slot — 
including slots 1 and 2 of the IIGS with a cooling fan 
installed. Datalink operates at 1200 or 300 baud. Built-in 
diagnostics check for accuracy of data transmission, and 
Datalink lets you track the progress of calls either elec- 
tronically or via an on-board speaker. 


Introductory offers from popular networks included. 
When you purchase Datalink, you'll get a fee-waived mem- 
bership to The Source worth $49.95. $60.00 worth of free 
on-line time from News Net. A free $50.00 subscription to the 
Official Airline Guide. A free subscription to the GEnie net- 
work worth $18.00! And information on MCI Mail. 


Order today! 

To order or for more informa- 
tion, see your dealer or call 
Applied Engineering today, 9 a.m. 
to 11 p.m. 7 days. Or send check 
or money order to Applied 
Engineering. MasterCard, VISA 
and C.0.D. welcome. Texas resi- 
dents add 614% sales tax. Add 
$10.00 outside U.S.A. 


Haves * 
Smartmodem | 
1200A 


= years or 
ears for $75 


Fal Applied Engineering 


The Apple enbancement experts. 


Box 798, Carrollton, TX 75006 
(214) 241-6060 


Smartmodem is a registered trademark of DC. Hayes Corporation 
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Greater Than and Less Than 


In order to compare two variables and determine which one is 
larger in value, we have to know something about the MEANING of 
the values. For example, if the values are ASCII characters, 
we may want "“A“ to be considered less than "“Z" for purposes of 
an alphabetic sort. Nevertheless, we also want “A* to be EQUAL 
to "a“! Even if the values are binary numbers there are still 
several possibilities. 


The following chart shows some popular numbering schemes: 


Scheme Smallest to Largest Range 
unsigned magnitude 00...7F 80...FF 0...255 
2's complement 80...FF 00...7F -128...+127 
l's complement 80...FE (FF,00) 0O1.../7F -127...+127 
sign/magnitude FF...81 (80,00) 01...7F -127...+127 


The first two are the ones usually used in the 6502 world. In 
1's complement and sign/magnitude there are two values for 
zero, Called +0 and -0. These schemes are built into the 
hardware in some machines, believe it or not. I used to like 
l's complement in the Control Data Corporation computers, and I 
liked sign/magnitude in the venerable Bendix G-15. You may 
occasionally find uses for these in the 6502, but normally you 
will be using unsigned magnitude or 2's complement. 


Notice that when comparing two values which are unsigned 
magnitudes, SFF is the largest value. When comparing two 
values which are in 2's complement, SFF is smaller than $00, 
and $7F is the largest value! Obviously we have to use 
different code for these two comparisons. 


The 6502 add, subtract, and comparison opcodes work equally 
well on magnitudes or 2's complement values. You just have to 
know how to interpret the results. When working with 
Magnitudes we need to keep track of the Carry status; when 
working with 2's complement we need to keep track of the Sign 
and the Overflow status. 


Here are some coding segments for comparing single byte 
variables in both magnitude and 2's complement forms. The code 
branches to L.GE.R if LEFT is greater than or equal to RIGHT, 
and falls through if LEFT is less than RIGHT: 


magnitude 2's complement 
SEC 
LDA LEFT LDA LEFT 
CMP RIGHT SBC RIGHT 
BCS L.GE.R BVC .l 
EOR #SFF 


-l BPL L.GE.R 
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Insist on GSRAM’ 


When You Buy Your IIGs” 


Expand the IIlGs RAM and ROM with the GSRAM or GSRAM Plus 
with ROM Pak Available now with 256K to 8 MEG! 


Ravens the 16K cards for the II+ and 
the 64K cards for the Ie? At the time, that 
much memory seemed like a lot But when 
the owners of these memory cards came to 
us for more memory, many had to throw 
away their smaller Apple memory cards or ty 
to sell chem. Most of our customers told us 
that had they known about Applied Engi- 
neering’s larger memory cards when they 
bought their Apple, they would have pur- 
chased them at the same time. 

GSRAM and GSRAM Plus are available now, 
allowing up to 8 MEG of memory expansion. 
Thats 8 times the memory capacity of 
Apple’s card and just look at the benefits that 
only GSRAM and GSRAM Plus have over 
Apple's card: 

e Lower cost 

e Has 6 RAM banks (Apple's card has 4) 

e Has memory expansion port 

e Has ROM expansion port 

e No configuration blocks to set 

e No soldered in RAM chips 

e Expandable to 8 MEG 

e Expands AppleWorks intemal limits 

e Built-in Hi-Res self - diagnostic software 

e 5 year hassle free warranty (Apple has a 90 
day warranty) 

e Made in USA 


GSRAM for More 
AppleWorks Power 

Onh GSRAM and GSRAM Plus climinate 
AppleWorks intemal memory limits, increas: 
ing the Maximum number of records avail: 
able from 6,000 to over 25,000 and only Gs 


RAM and GSRAM Plus increase the number 


of lines permitted in the word processing 
mode from 6,000 to over 15,000. And only 
GSRAM and GSRAM Plus offer a builtin 
printer buffer so vou can continue using 
Appleworks while your printer is printing, Gs 
RAM and GsRAM Plus even expand the 


number of lines in the dipboard from 255 to | 


2047 and will auto segment large files so thev 
can be saved on wo or more disks. You can 


With an optional piggyback card, you can 
expand GSRAM even higher than 1.5 MEG! 
(Other cards are only expandable to 1 MEG.) 
GSRAM Plus—for Growing 
by Leaps and Bounds 

GSRAM Plus is the first Apple memory card to 
use 1 MEG RAM chips on the main board. 
Irs available with 1 to 6 MEG on board. If 
you don’t need the whole 6 MEG now, vou 
can buy a GSRAM Plus with less memory and 
easily expand it in the future. 

GSRAM Plus can be expanded up to 8 
MEG with an optional piggyback card 
Easy Expansion 

Both GSRAM and GsSRAM Plus use standard 
RAM chips that are readily available and just 
plug right in So unlike other cards, you'll find 
expanding your GsRAM or GSRAM Plus easy, 
convenient and very economical And with 
Our optional ROM expansion module you 
can even increase the IIGs’s ROM space and 
all in just one slot 
Quality and Support of the 
Industry Leader 

Applied Engineering is the largest supplier 
of Apple peripherals in the world We 
invented the first large RAM cards for the 
Apple. With a 5-year “no-hassle” warranty and 
outstanding technical support, you can be 
sure GSRAM and GSRAM Plus will deliver the 
performance you're looking for—or retum 
them within 15 days for a full refund. 


even have Pinpoint or Macroworks and your 
favorite spelling checker in RAM for instant 
response. GSRAM and GSRAM Plus will even 
display the time and date right on the 
AppleWorks screen. Nothing comes close to 
enhancing AppleWorks so much. 
Turn Your Ilcs into a Giant 

Simply plug GSRAM into the IIGs memory 
expansion slot and you've got up to 8 mega- 
bytes of RAM at vour fingertips—all of it 
instantly and automatically recognized by the 
IlGs. GSRAM is compatible with all Ics 
software, including AppleWorks, as well as 
BASIC®, ProDos, DOS 3.3, PASCAL®, “C” and 
CP/M®. 


Grow by Bytes or Megabytes 

We offer GSRAM in two configurations so 
you can increase your memory 256K at a 
time (GSRAM) or a megabyte at a time (Gs- 
RAM Plus). Both offer full compatibility, lower 
cost than other boards, and easy expandabil- 
ity. And both are extremely low in power 
consumption. A fully expanded GsRAM oper- 
ates at only 375 ma, and GSRAM Plus at only 
270 ma (even with 6 megabytes on board!) 
GSRAM—for Normal 
Memory Requirements 

GSRAM is available with 256K, 512K, 1 
MEG or 1.5 MEG of memory already on 
board. If you don’t need the full 1.5 MEG 
now, you can choose a GSRAM with less 
memory and expand it up to 1.5 MEG in the 
furure—or upgrade to GSRAM Plus for a 
small charge. 


GSRAM with 256K 
GSRAM with 512K 
GSRAM with 1 MEG 
GSRAM with 1.5 MEG 


GSRAM with 2-8 MEG 


GSRAM PLUS with 1 MEG 
GSRAM PLUS with 2 MEG 
GSRAM PLUS with 3-8 MEG 


Order today! 

See your dealer or call Applied Engineering 
today, 9 am. to 11 pm 7 days Or send 
check or money order to Applied Engineer- 
ing MasterCard, VISA and CO.D. welcome. 
Texas residents add 644% sales tux. Add $10.00 
outside USA 
- “In quality: 

Performance. 
compatibility. 
expandability and 
support, Applied 
Enginecrtngs OSRAM 
and GoSRAM Plus are 
number one.” H 


ZC. APPLIED ENGINEERING” 


| Tbe Apple enhancement experts. 
(214) 241-6060 


P.O. Box 798, Carrollton, TX 75006 


Steve Wozniak the creator 
of Apple Computer 


CP Mis a registered trademark of Digital Research. Inc. 
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The following code branches to L.LE.R if LEFT is less than or 
equal to RIGHT, and falls through if LEFT is greater than 
RIGHT : 


magnitude 2's complement 
SEC 
LDA RIGHT LDA RIGHT 
CMP LEFT SBC LEFT 
BCS L.LE.R BVC .1l 
EOR #SFF 


-l BPL L.LE.R 


The following code branches to L.EQ.R if LEFT is equal to 
RIGHT, to L.GT.R if LEFT is greater than or equal to RIGHT, and 
falls through if LEFT is less than RIGHT: 


magnitude 2's complement 
SEC 
LDA LEFT LDA LEFT 
CMP RIGHT SBC RIGHT 
BEQ L.EQ.R BEQ L.EQ.R 
BCS L.GT.R BVC .l 
EOR #SFF 


Now here are some coding segments for comparing double byte 
variables in both magnitude and 2's complement forms. These 
examples perform the same as those given above, but consider 
16-bits rather than 8: 


magnitude 2's complement 
LDA LEFT LDA LEFT 
CMP RIGHT CMP RIGHT 
LDA LEFT+1 LDA LEFT+1 
SBC RIGHT+1 SBC RIGHT+1 
BCS L.GE.R BVC .1 

EOR #SFF 


-l BPL L.GE.R 


Notice that the low-order bytes are compared in both cases as 
magnitudes, which they are. If LEFT is greater than or equal 
to RIGHT, Carry will be set; otherwise, it will be cleared. 
This primes the pump for the SBC of the high-order bytes. You 
can extend this to any larger number of bytes by just including 
more LDA-SBC pairs (after the one shown) for all the 
higher-order bytes in sequence. 
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Serial Pro’ 
The intelligent 


Applied Engineering. 


Serial Pro is a powerful multifunction card for the Apple Ile, 
I+, [lcs and compatible computers. Serial Pro combines a 
powerful serial port for interfacing to a printer, modem or other 
serial device, with a full function clock/calendar. Serial Pro’s serial 
port is compatible with virtually all letter quality and dot matrix 
printers, including Apple’s Imagewriter and Imagewriter II, and 
can communicate with the fastest external modems at baud rates 
from 50 to 19,200. 


to program serial parameters or disks to use. Serial Pro has a 
built-in setup screen that allows all parameters to be set And on- 
screen help that makes it super-easy. An on-board battery stores 
your selections for over 20 years, but you can change them at 
any time. Serial Pro is the perfect upgrade for Super Serial card 
owners looking for more performance or a built-in clock 


Serial Port Features e Fully Super Serial Card compatible but 
more versatile and easier to use e Compatible with printers 


and black/white inversion e Variable word length, number of 
stop bits and parity selection e Crystal controlled circuits are 
used to provide ultra accurate baud rates. 


Clock Calendar Features e ProDos, DOS and AppleWorks 
compatible. Displays time and date on the AppleWorks screen 
e Automatically time and date stamps AppleWorks files 20 
year auto recharging nickel-cadmium battery e Realtime inter- 
rupts © Built-in on screen time and date settings (no software 
needed) ¢ Does not use phantom slots. 

Serial Pro is perfect for Apple ffe, I+, Ics or compatible 
owners in need of a serial port or clock/calendar or both. But 
unlike other multifunction cards on the market, Serial Pro does 
not use phantom slots, so all the slots in your computer are 
useable. 

Serial Pro comes complete with manual, cable and instructions 
for connecting to all the leading printers and modems. 


to 11 p.m. 7 days. Or send check or money order to Applied 
Engineering. MasterCard, VISA and CO.D. welcome. Texas 
residents add 5%% sales tax. Add $10.00 outside U.S.A 
AE. APPLIED ENGINEERING” 
The Apple enbancement experts 
(214) 241-6060 


P.O. Box 798, Carrollton, TX 75006 
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multifunction card from 


Set up is easy, because unlike other cards, there are no switches 


e Compatible with modems e Prints graphics to printer (without 
software) in normal mode, 90° rotation, double size, side by side, 


Serial Pro $159 


Order Today! See your dealer or call Applied Engineering, 9 am. 


With the 
7-80 Plus; run 
over 5000 new 

CP/M’ programs. 


Now, get two computers 
in one and all the 
advantages of both 


E nter the CP/M world with the new Z-80 Plus card from 
Applied Engineering, and introduce your Apple Ile, Ics or 
II+ to thousands of CP/M programs. Only the Z-80 Plus comes 
standard with the new 5.1 software, the most advanced system 
ever for running CP/M programs. 

The new 5.1 boasts advanced features like built-in disk 
emulation for popular memory expansion boards, boosting both 
system speed and storage capacity. And menu-driven utilities that 
let you get to work faster. The Z-80 Plus also lets you run older 
CP/M programs— all the way down to Version 1.6 (2.2 is the 
most popular). 

The Z-80 Plus is the only card on the market capable of 
accessing more than 64K. If you have an extended 80-column 
card, all 128K is usable. And if you have RamWorks, RamFactor, 
GsRam, GsRam Plus, or an Apple memory card in your Ile, Ics or 
II+, up to 1088K is available. 

Each Z:80 Plus comes with our CP/M Ram Drive software, 
enabling most memory cards to work as a high-speed Ram disk 
so CP/M software can run up to twenty times faster. So packages 
like WordStar, dBASE II, Turbo Pascal and most others run at 
blinding speed. 

Simply plug the Z-80 Plus into any slot in your Apple. You'll 
get the benefits of two computers in one—all at an unbelievably 
low price (only $149!). 


e Fully compatible with ALL CP/M software — e Fully compatible 
with 5%" and 3¥2" disk drives as well as most hard disks includ- 
ing the Sider —e Fully compatible with Microsoft disks (no pre- 
boot required) —e Specifically designed for high speed opera- 
ton  e Runs WordStar, dBASE II, Turbo Pascal, and ALL other 
CP/M software with no pre-boot —e Semi-custom LC. and low 
parts count allows Z-80 Plus to fly through CP/M programs with 
extremely low power consumption (we use the Z-80B) e« Does 
EVERYTHING other 2-80 boards do, plus Z-80 interrupts 

e Five-year warranty 


To get your Z-80 Plus or for more information see your 
dealer, or call 214-241-6060 9 a.m. to 11 p.m. seven days, or send 
check or money order to Applied Engineering. MasterCard, VISA 
and C.O.D. welcome. Texas residents add 5%% sales tax. Add 
$10.00 outside U.S.A 


y= Applied Engineering” 
P.O. Box 798, Carrollton, TX 75006 
(214) 241-6060 


CPM is a registered trademark of Digital Research 


Here is the pair of code segments for the “less than or equal" 
comparison: 


magnitude 2's complement 
LDA RIGHT LDA RIGHT 
CMP LEFT SBC LEFT 
LDA LEFT+1 LDA LEFTt1 
SBC RIGHT+1 SBC RIGHT+t1 
BCS L.LE.R BVC .1l 

EOR #SFF 


-l BPL L.LE.R 


Here is the pair of code segments for branching three ways: 


magnitude 2's complement 
SEC 
LDA LEFT+1 LDA LEFT+1 
CMP RIGHT+1 SBC RIGHT+1 
BNE .1 BEQ .2 
LDA LEFT BVC .l 
CMP RIGHT EOR #SFF 
BEQ L.EQ.R -l BPL L.GT.R 
-l1 BCS L.GT.R BMI L.LT.R 
~2 LDA LEFT 
CMP RIGHT 
BEQ L.EQ.R 
BCS L.GT.R 


This one was a lot trickier, because of the need to separate 
the EQUAL case. I reversed the order of the tests, testing the 
high-order bytes first. 


There are many other variations and many other ways of doing 
the same thing. I hope this helped to shed some light, and will 
help you to write more efficient and more clear code in the 
future. 
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